-
Notifications
You must be signed in to change notification settings - Fork 10.3k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
feat(www): Convert API pages to MDX #20763
Conversation
…rted some api docs to MDX, but they still need to be verified. More testing is needed.
…cts data directly to be used within components of hte page, all MDX files have been adjusted. This exposes the headings for translation.
…nted in the root of the file, which is consistent with the other doc files.
…files, not a regexp. Updated mdx to new convention.
…s. Perhaps someday they can be added with the suggested names. Fixed issue where types were not shown on top level items in `node-api-helpers.mdx`. They were a side-effect of how the api jsdoc was written/queried, should they not exist?
Will have to deal with the merge conflicts but this makes sense to me. I'd definitely like some input from someone on Core when they're able. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is great! Just couple of changes and we can get this in!
Co-Authored-By: Michal Piechowiak <misiek.piechowiak@gmail.com>
Co-Authored-By: Michal Piechowiak <misiek.piechowiak@gmail.com>
Co-Authored-By: Michal Piechowiak <misiek.piechowiak@gmail.com>
@pieh merged in all the changes! Should be straightforward but I'm waiting for my local build to finish to test that everything works out well. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Awesome!
Thanks @Sever1an for initial work and @tesseralis for finishing it up!
Update of @Sever1an's PR here to bring it up to date with master.
Make all the API pages markdown pages with their own custom template
template-api-markdown
. Frontmatter can be used to determine what JSDoc to query, API calls to use, etc.Related Issues
Fixes: #19035